home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 43 / Amiga Format CD43 (1999)(Future Publishing)(GB)(Track 1 of 2)[!][issue 1999-09].iso / -serious- / graphics / sfwjpg / doc / usage.txt < prev    next >
Text File  |  1999-06-15  |  4KB  |  130 lines
  1. #
  2. # usage.txt
  3. # 
  4. # Copyright (c) 1997-1999  Everett Lipman
  5. #
  6. # This document is free software; you can redistribute it and/or
  7. # modify it under the terms of the GNU General Public License
  8. # as published by the Free Software Foundation; either version 2
  9. # of the License, or (at your option) any later version.
  10. # 
  11. # This document is distributed in the hope that it will be useful,
  12. # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14. # GNU General Public License for more details.
  15. # 
  16. # The GNU General Public License is available at
  17. #
  18. #    http://www.fsf.org/copyleft/gpl.html
  19. #
  20. # Alternatively, you can write to the 
  21. #
  22. #    Free Software Foundation, Inc.
  23. #    59 Temple Place - Suite 330
  24. #    Boston, MA  02111-1307, USA
  25. #
  26.  
  27. #
  28. # 9 May 1999
  29. #
  30.  
  31. This file describes the usage of the programs sfwjpg, pwpjpg,
  32. pwpext, and the Independent JPEG Group's jpegtran.
  33.  
  34.  
  35. Limitations:
  36.  
  37.   The programs sfwjpg and pwpjpg convert from Seattle
  38.   FilmWorks's private file formats to JFIF (JPEG File Interchange
  39.   Format).  As far as I am aware, Seattle FilmWorks does not
  40.   make public the specifications of these formats.  The format
  41.   specifications were deduced by examining a number of
  42.   .sfw and .pwp files, and may not be entirely accurate.  In
  43.   particular, some .sfw files which were downloaded from the SFW
  44.   web site were not properly converted to JFIF.  All .pwp files
  45.   which were downloaded from SFW and tried have been converted
  46.   without any problems.
  47.  
  48.   Converted images will need to be flipped vertically.  This can
  49.   be done with jpegtran.  The jpegtran program is part of the
  50.   Independent JPEG Group's free software, which can be obtained
  51.   from
  52.  
  53.   ftp://ftp.uu.net/graphics/jpeg 
  54.  
  55.   pwpext is a UNIX (Bourne) shell script, and will not work unless
  56.   pwpjpg and jpegtran are in the execution search path ($PATH) when
  57.   it is invoked.
  58.  
  59.  
  60. sfwjpg
  61.  
  62.   sfwjpg will take a single .sfw file and convert it into a
  63.   .jpg (JFIF) file.  The image in the newly created .jpg file
  64.   will then need to be flipped vertically.  sfwjpg takes one or
  65.   two arguments, the name of the .sfw file to be converted, and
  66.   an optional output file:
  67.  
  68.   sfwjpg mypic.sfw
  69.  
  70.   This will create the file mypic.jpg in the current directory.
  71.   mypic.sfw will not be altered or removed.  Under Microsoft
  72.   Windows, sfwjpg.exe must be invoked from the run window
  73.   command line.
  74.  
  75.   sfwjpg mypic.sfw foo.jpg
  76.  
  77.   This will convert mypic.sfw and leave the result in foo.jpg.
  78.  
  79.   sfwjpg mypic.sfw -
  80.  
  81.   This will convert mypic.sfw and write the result to the standard
  82.   output.
  83.  
  84.  
  85. pwpjpg
  86.  
  87.   pwpjpg will take a .pwp file and extract the images in the
  88.   file.  A .pwp file typically contains the scanned images from
  89.   an entire roll of film.  The names of the images are contained
  90.   within the .pwp file.  pwpjpg takes a single argument, the
  91.   name of the .pwp file from which to extract the images:
  92.  
  93.   pwpjpg mypics.pwp
  94.  
  95.   This will extract all of the images contained in mypics.pwp
  96.   and write them in the current directory as .jpg (JFIF) files.
  97.   The file names will correspond to the names of the images
  98.   stored in the .pwp file.  mypics.pwp will not be altered or
  99.   removed.  Under Microsoft Windows, pwpjpg.exe must be invoked
  100.   from the run window command line.
  101.  
  102.  
  103. pwpext
  104.  
  105.   pwpext is a UNIX (Bourne) shell script which extracts and
  106.   flips the images from a .pwp file.  It takes a single
  107.   argument, the name of the .pwp file:
  108.  
  109.   pwpext mypics.pwp
  110.  
  111.   This will extract, flip, and store as .jpg files all of the
  112.   images contained in mypics.pwp.  mypics.pwp will not be
  113.   altered or removed.
  114.  
  115.  
  116. jpegtran
  117.  
  118.   jpegtran will do a lossless vertical inversion of the image in
  119.   a .jpg file.  This is a complicated process which is described
  120.   in details.txt.  jpegtran can use use standard input and output:
  121.  
  122.   jpegtran -flip vertical < mypic.jpg > myflippedpic.jpg
  123.  
  124.   This will create the file myflippedpic.jpg, which will contain
  125.   the same image as mypic.jpg, except that the vertical ordering
  126.   of the scan lines will be reversed in myflippedpic.jpg.  This
  127.   flipping can be done by most image processing programs, though
  128.   usually not without some gain in file size and/or loss in
  129.   image quality.
  130.